home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / comm / autoprcm.zip / AUTOPRCM.DOC < prev    next >
Text File  |  1986-09-21  |  11KB  |  226 lines
  1. .op
  2. .po 0
  3.                                AUTOPRCM.COM
  4.  
  5.                        Version 2.0 - September 1986
  6.  
  7.         Copyright (C) 1986 - John L. O'Boyle - All Rights Reserved
  8.  
  9.      A  routine  to  generate DOWNLOAD scripts (.CMD  files)  for  ProComm* 
  10. version 2.4 and greater.  
  11.  
  12.      This   program was developed after seeing a version originally written 
  13. by  Keith Peterson.   The one I saw had been modified for use with  PIBTERM 
  14. and RBBS systems only.   While RBBS is nice,  it's not the ONLY Host System 
  15. in  the world!   I've included File Transfer Protocol and Host options  for 
  16. several popular systems.  If the routine is well-received, I'll continue to 
  17. update it as hosts systems (or ProComm) change.
  18.  
  19. FORWARD:
  20.  
  21.      One  of the nicest features of ProComm (this authors opinion only)  is 
  22. it's CMD processor!   CMD files contain, among other things, the keystrokes 
  23. you  would normally have to enter manually for a given task.   The  ProComm 
  24. documentation covers this subject much more completely and  elegantly,  but 
  25. the  "biggies" are the WAITFOR  statement and the TRANSMIT statement.   The 
  26. WAITFOR statement says.."wait until these characters are received from  the 
  27. host".   The  TRANSMIT statement says.."send these characters to the host." 
  28. You can see where, with a little experimentation, you could build a file to 
  29. do  just about anything you wanted,  provided you KNEW what to expect  from 
  30. the host.
  31.  
  32.      CMD  files can be built with any editor or word-processor.   Many  BBS 
  33. systems  offer ProComm CMD file examples that will completely automate  the 
  34. logon sequence for their particular system.   These need only be downloaded 
  35. and modified for your individual use,  ie;  change the sample-name to  YOUR 
  36. name, etc.
  37.  
  38.      CMD  files can be executed directly from the DOS command line when you 
  39. execute ProComm.   (Again,  please refer to the documentation that Tom  and 
  40. Bruce  provide.) Using this feature,  it's possible to execute ONE DOS com-
  41. mand  which will invoke ProComm,  execute a CMD file which will logon to  a 
  42. given host, go directly to the <F>iles section, download a list of the most 
  43. recent file additions,  logoff the host system,  disconnect the phone line, 
  44. print the downloaded list,  and exit ProComm.   (I do it all the time...and 
  45. by using the TEF program, I do it in the middle of the night when the rates 
  46. are lower!)
  47.  
  48.      If  you haven't yet discovered the CMD feature of ProComm,  maybe  AU-
  49. TOPRCM will help you get started!
  50.  
  51. OPERATIONAL CONSIDERATIONS:
  52.  
  53.      This  program may be run from WITHIN ProComm,  to produce an immediate 
  54. ".CMD" file for file transfers.   I've substituted it's name for the Editor 
  55. option   in   my PROCOMM.PRM.   While on-line to a system,  the  ALT-A  key 
  56. sequence initiates the program.   Of course it can be run stand-alone  any-
  57. time!
  58.  
  59.      I  suggest that users run the program a few times to  become  familiar 
  60. with  the  files  produced.   (AUTOPRCM produces ONE output file  per  run, 
  61. called  "DOWNLOAD.CMD")  The .CMD will be activated  at  different  prompts 
  62. depending on the host system.   Once you know what the FIRST command in the 
  63. file  does,  you'll  only have to get to the requisite prompt on  the  host 
  64. system and trigger the .CMD file via ProComms' ALT-F5 key sequence.
  65.  
  66.      It's recommended that .CMD files,  created via AUTOPRCM, NOT be run in 
  67. an  unattended mode!   A misspelling of a file name and/or changes in  host 
  68. prompts may cause the .CMD to WAIT on an unexpected prompt.  If a .CMD file 
  69. hangs, the ESC key will return you to manual control.
  70.  
  71.      It's also recommended that you have a copy of the host download direc-
  72. tory handy when you create your .CMD file,  or at least good clear notes if 
  73. you're running the program dynamically.   Scan the host directories for the 
  74. files you want,  make a list of those files,  and USE the list when you are 
  75. running AUTOPRCM.
  76.  
  77.  
  78. MINIMAL NOTES ON SUPPORTED HOSTS:
  79.  
  80. RBBS - Currently only provides Xmodem protocol.  (ASCII was not included in 
  81. AUTOPRCM  since most useful files are not stored in that form.) Since  RBBS 
  82. allows the download command,  the file name,  and the protocol option to be 
  83. specified via a single string,  (ie;  "D;ANYFILE.BAS;X") the "DOWNLOAD.CMD" 
  84. file begins with this command.
  85.  
  86. IBBS - The above notes from RBBS apply here also.
  87.  
  88. Source  IBMSIG  - The  DOWNLOAD.CMD begins from a MAIN SYSTEM  PROMPT  ">", 
  89. external to the IBMSIG!
  90.  
  91. PC-Board  - The  transfer protocol you use from a PC-Board system  is  con-
  92. tained in your PC-Board user profile.   Be certain that the one you  choose 
  93. for  AUTOPRCM matches that used in the PC-Board system you  contact.   This 
  94. .CMD starts from the "Enter File Name" prompt.
  95.  
  96. EXEC-PC - Download via Kermit,  Xmodem and Ymodem.  Expects to find prompts 
  97. generated by the e<X>pert Mode.
  98.  
  99. FIDO  - Prompts  and  protocols for FIDO systems are in a  state  of  flux.  
  100. AUTOPRCM supports Xmodem,  Kermit,  Telink,  and Modem7.   This .CMD starts 
  101. from the "Enter File Name" prompt.
  102.  
  103. PC-HOST    - These systems do not use filenames for security  reasons.   Files 
  104. are selected via number from a directory list.   AUTOPRCM will BEGIN with a 
  105. directory change command,  and continue from there.   For Kermit and Ymodem 
  106. Batch, only the Dir # and File # must be specified.  For Xmodem amd Ymodem, 
  107. an additional file name is required.
  108.  
  109.     CRC-16 verification will be always be utilized where available.
  110.  
  111. CAVEAT:
  112.  
  113. The  various  host  system prompts that are produced in  AUTOPRCM  for  the 
  114. WAITFOR  command were accurate as of this release!   I have NO control over 
  115. these  prompts  if they have been changed by a given Sysop for his  or  her 
  116. particular software.   Should you discover that a system prompt has changed 
  117. (and  it MUST be for the generic system,  ie;  ALL RBBS systems),  I'll  be 
  118. happy to modify the code if you let me know what's changed.  Notes, sugges-
  119. tions,  or  comments on AUTOPRCM can be left on the PConnecticut BBS  (203) 
  120. 521-1991  (1200/2400 only).   The LATEST version of AUTOPRCM.COM can ALWAYS 
  121. be   found  on that system,   the Datastorm Technologies System,   and  the 
  122. IBMSIG on  The Source.
  123.  
  124.     To change AUTOPRCM default values, see the section on Auto-patch.     
  125.  
  126. BATCH MODE OPERATION:
  127.      AUTOPRCM  batch-mode was the result of a (what I first thought was  an 
  128. unusual)  user request.   I initially didn't see the advantage to be gained 
  129. in using .BAT files to do ALL the work.   I now LIKE the idea of being able 
  130. to use a "list of new files" for example from RBBS, and just plug that file 
  131. into the AUTOPRCM.DAT file.   Saves having to re-key (and possible mis-key) 
  132. the file names!
  133.  
  134. Basically...
  135.      AUTOPRCM LOOKS for a file named "AUTOPRCM.DAT".   If it finds  it,  it 
  136. operates  in  "batch" or "semi-automatic" (discussed later) mode.   In  the 
  137. absence of AUTOPRCM.DAT, the program operates as originally designed.
  138.  
  139.      The particulars are...  You ALWAYS get Auto-logoff.  If the FIRST line 
  140. of AUTOMENU.DAT is NOT a PATHSPEC, the default is used.  The SECOND line of 
  141. AUTOPRCM.DAT  (or the first if the path is missing) MUST be a system  name, 
  142. Source,  CServe, TComm, etc.  It's not case-sensitive, and only scans  four 
  143. characters, so you don't even have to spell it all the way out.
  144.  
  145.      The third line (or second..see above) is the Transfer  Protocol.  Same 
  146. thing  here.  Only scans four characters and either upper or lower case  is 
  147. fine.   Subsequent  lines are file names.   AUTOPRCM  extracts to the FIRST 
  148. blank,  so  it's  possible  to leave the descriptions in the  line  if  you 
  149. prefer.   (I  did that with the RBBS listing.)  That's about  it.   There's 
  150. almost NO error checking.  If a filespec length is bad, it STAYS that way.
  151.  
  152. SEMI-AUTOMATIC MODE:
  153.      Turns  out  that after the coding for the batch-mode was  complete,  I 
  154. ended up with a semi-automatic mode without doing any further work.
  155.  
  156.      If  AUTOPRCM.DAT exists,  AUTOPRCM will look at  it!   Straight  ASCII 
  157. file.   Nothing special.   The FIRST thing AUTOPRCM expects to see is a new